home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / security / xinetd / INSTALL < prev    next >
Encoding:
Text File  |  1993-06-28  |  4.4 KB  |  118 lines
  1.  
  2. 1. Distribution
  3.  
  4. xinetd depends on some of my libraries. These libraries are included in
  5. the distribution as separate tar files.  The complete xinetd
  6. distribution consists of the following files:
  7.  
  8.     unpack-src:                    shell script
  9.     compile-src:                shell script
  10.     xinetd.VERSION.tar:        program source
  11.     fsma.VERSION.tar:            library source
  12.     misc.VERSION.tar:            library source
  13.     pset.VERSION.tar:            library source
  14.     sio.VERSION.tar:            library source
  15.     str.VERSION.tar:            library source
  16.     xlog.VERSION.tar:            library source
  17.     README:                        what xinetd is about
  18.     INSTALL:                        this file
  19.  
  20. The purpose of the scripts is to make installation easier.
  21.  
  22.  
  23. ----------------------------------------------------------------------
  24.  
  25. 2. Installing xinetd
  26.  
  27. unpack-src will unpack the tar archives creating the following directory
  28. structure:
  29.     ./xinetd
  30.     ./libs
  31.     ./libs/include
  32.     ./libs/man
  33.     ./libs/lib
  34.     ./libs/{sio,pset,fsma,misc,xlog}
  35.  
  36. NOTE: If the archives are compressed, the script will uncompress them.
  37.  
  38. WARNING: unpack-src will delete the directories "./xinetd" and "./libs" if 
  39.             they exist already.
  40.  
  41. compile-src compiles the libraries and then compiles xinetd.
  42. "compile-src -help" will list all available options.
  43. It knows about some operating systems. When you invoke it, it will ask
  44. you if your OS is among those it knows about. If so, all you need to do
  45. is type the OS name.  If you have a different OS, compile-src will try
  46. to configure xinetd appropriately.
  47.  
  48. The script will also ask you questions when it can't figure out
  49. something.  For every question that it asks, there is a command line
  50. option, so in case you need to run the script more than once, you can
  51. use the command line option to avoid having to answer the question
  52. multiple times.
  53.  
  54. It is recommended that every time you make changes to xinetd or to the
  55. libraries it uses, you cd to the top level directory (the one
  56. containing the directories "libs" and "xinetd") and run the script
  57. compile-src. This script invokes make with arguments that override
  58. variables defined in the Makefiles.
  59.  
  60. The Sprint function in the SIO library depends on the word size of your
  61. machine. Its behavior depends on the SIO configuration file and all
  62. existing SIO configuration files assume a 2's complement machine with a
  63. 32-bit word size.  Furthermore it is assumed that sizeof( int ) =
  64. sizeof( long ).  If these assumptions are not valid, you will need to
  65. provide an appropriate SIO configuration file (check the instructions
  66. in the README file in the sio directory).
  67.  
  68. The file "xinetd/config.h" contains configuration constants that you
  69. may want to change (one possibility is my choice of the signals that
  70. control the daemon's behavior).
  71.  
  72. If at any time you want to start all over again, you can run the script
  73. unpack-src again and then proceed with running compile-src. However, if
  74. you have made any changes to the source, they will be lost since
  75. unpack-src will delete the existing "xinetd" and "libs" directories
  76. and create new ones (it will prompt you before deleting anything).
  77.  
  78. When the compilation is over, the xinetd executable will be in the
  79. "xinetd" directory. If you want to install it in one of the system
  80. directories, cd to the "xinetd" directory and type:
  81.  
  82.     make install BINDIR=<install program here> MANDIR=<install man page here>
  83.  
  84. For example:
  85.  
  86.     make install BINDIR=/usr/local/bin MANDIR=/usr/local/man/man1
  87.  
  88. The reason for putting the program in a directory like /usr/local/bin
  89. is that this is not a program that is only useful to superusers.
  90.  
  91.  
  92. ----------------------------------------------------------------------
  93.  
  94. 3. Epilogue
  95.  
  96. Here are a few things worth mentioning:
  97.  
  98. 1. You can use the program "itox" in the "xinetd" directory to convert
  99.     inetd.conf to a xinetd configuration file. The program works as a
  100.     filter, i.e. 
  101.             itox [-daemon_dir dir_name] < inetd.conf > xinetd.conf
  102.     The -daemon_dir option is useful in case you are already using tcpd for 
  103.     access control. It specifies the directory name where tcpd expects
  104.     to find the daemon programs.
  105.     The itox program will also be compiled by the compile-src script.
  106.     
  107. 2. A sample xinetd configuration file is included: xinetd/sample.conf 
  108.  
  109. 3. I have been using xinetd on a Sun SparcStation running SunOS 4.1 and 
  110.     I have compiled it (but not used it) on a DECstation running Ultrix 4.2.
  111.  
  112. 4. You may find the libraries useful in their own right.
  113.  
  114. 5. The file BUG-REPORTS contains instructions on how to send bug reports.
  115.  
  116. 6. The file PORTING has instructions on how to port xinetd to other OS's.
  117.  
  118.